home *** CD-ROM | disk | FTP | other *** search
-
- BellPrefs
- ---------
- Documentation for version 2.1, on January 16th, 1992
-
- by Bruno Costa
-
-
-
- WARNING
-
- Although this program is freely distributable (see COPYRIGHT below), I
- would appreciate if you take the time to write me a line or two (E-Mail
- please) if you are using any of my programs or if you have any kind of
- ideas or suggestions (This is not too much to ask, is it?). If you feel
- particularly generous, I would like to receive a disk with any useful
- programs you have written, preferrably with source. Thanks!
-
-
- DESCRIPTION
-
- BellPrefs is an interactive, Intuition based preferences module that can
- be used to configure Bell. It uses the WB 2.0 user interface style, and
- works just like the preferences modules already in your SYS:Prefs drawer.
- It allows a digitized sound to be selected through a file requester, and
- played with any combinations of volume and pitch values. The sound
- waveform is displayed graphically, and the program works under WB 2.0 only.
-
-
- OPTIONS
-
- usage: BellPrefs (no options)
-
- The program is completely interactive, and does not support command line
- parameters (yet?). It can also be run from Workbench, and an appropriate
- icon is provided so that it can be placed in your SYS:Prefs drawer. When
- run, it opens a window with a couple of gadgets and menu items that will be
- described:
-
- GADGETS:
-
- Visual Bell: determines if the bell should be visible, i.e., if the
- screen should flash when an error occurs.
-
- Audible Bell: determines if the bell should be audible, i.e., if the
- sound should be played when an error occurs.
-
- Volume: determines the volume at which the sound is to be played,
- ranging from 0 to 64 (loudest).
-
- Speed: determines the speed at which the sound is to played, ranging
- from 4000 to 16000 (fastest). The faster a sound is played, the higher the
- pitch will be.
-
- Sound File: this string gadget contains the full pathname of the IFF
- 8SVX sound file. If you type a pathname and hit return, the sound will be
- loaded and the volume and speed gadgets will be changed to reflect the
- default values stored in the file.
-
- Select: this gadget brings up a file requester to select interactively
- the sound file pathname.
-
- (Graphic): this gadget, when hit, will simulate what will happen in an
- error condition according to the current settings. This may produce a
- screen flash (if the Visual Bell is enabled) or a sound (if the Audible
- Bell is enabled) or both (or even none).
-
- Save: saves the current preferences on disk (ENVARC:).
-
- Use: saves the current preferences in memory (ENV:), and signals Bell
- that the preferences have been changed.
-
- Cancel: self-explanatory.
-
-
- MENUS:
-
- Project/Open...: loads a bell preferences file, selected from a file
- requester.
-
- Project/Save As...: saves a bell preferences file, in a file selected
- from a file requester.
-
- Project/Quit: quits.
-
- Edit/Reset To Defaults: resets all options to the internal defaults.
-
- Edit/Last Saved: resets all options to the ones saved in ENVARC:.
-
- Edit/Restore: resets all options to the ones saved in ENV:.
-
-
- BUGS
-
- Should support some command line parameters, just like the system
- preferences modules.
-
-
- AUTHOR
-
- The accompanying program and this documentation were written by Bruno
- Costa. He can be reached in the following ways:
-
- E-Mail: bruno@brlncc.bitnet (InterNet)
- bruno@BRLNCC (BitNet)
-
- Mail: Bruno Costa
- Rua Almirante Guilhem 454/102 bloco 1
- Leblon - Rio de Janeiro
- RJ 22440
- BRAZIL
-
-
- COPYRIGHT
-
- This program is copyrighted by Bruno Costa. It may be freely distributed
- if and only if the documentation and the executables are provided in
- original form. It may be included in Public Domain/Shareware compilations,
- like the one organized by Fred Fish, as long as just a nominal fee is
- charged for each disk (no more than US$10 per disk), and may also be
- uploaded to BBS's or network services like BIX and CompuServe.
-
-
- DISCLAIMER
-
- The author makes no warranty of any kind with respect to this product and
- explicitly disclaims any implied warranties of merchantability or fitness
- for any particular purpose.
-